QuickTime 3 Reference

Parameter Dialog Box Preview Image Specifier

This data structure contains a picture that will be used as one of the preview images in the preview window of the standard parameters dialog box. The preview window shows previews of the effects the user chooses in the dialog box. QuickTime provides a default images, but you can replace one or more of these by calling QTStandardParameterDialogDoAction (or its low-level equivalent, ImageCodecStandardParameterDialogDoAction ) with a pdActionSetPreviewPicture action selector.

The sourceID numbers correspond to the sources an effect uses. For example, an effect that uses one source will use the preview image with sourceID set to 1, while a two source effect will use preview pictures 1 and 2.



 
struct QTParamPreviewRecord {

    long        sourceID;

    PicHandle   sourcePicture;

};

typedef struct QTParamPreviewRecord QTParamPreviewRecord;

typedef QTParamPreviewRecord *QTParamPreviewPtr;

sourceID: The number of the preview image.
sourcePicture: The preview image itself.